How to build.txt

   1 Everything should compile fine using NAnt 0.85 final. \r
   2 You can find the latest version at http://nant.sourceforge.net/ \r
   3 \r
   4 Anyway, the following are some useful tips if things go wrong for some reason.\r
   5 \r
   6 Where to start the build?\r
   7 =========================\r
   8 \r
   9 Use the default.build in the root directory. It compiles everything in the right order, copies dependencies and so on. \r
  10 \r
  11 Simply type\r
  12 \r
  13   > nant\r
  14 \r
  15 Database tests\r
  16 ==============\r
  17 \r
  18 If you have MS SQL Server installed (default instance) just create two databases:\r
  19 \r
  20 - test\r
  21 - test2\r
  22 \r
  23 If not, and you want to run the database tests, you must set the connection string, dialect and driver through NAnt defines. Otherwise you can disable the tests (see below).\r
  24 \r
  25 The basic NHibernate settings can be set as NAnt arguments:\r
  26 \r
  27 - ar.dialect sets the NHibernate dialect\r
  28 \r
  29     > -D:ar.dialect=NHibernate.Dialect.MsSql2000Dialect\r
  30 \r
  31 - ar.connection.driver_class sets the driver\r
  32 \r
  33     > -D:ar.connection.driver_class=NHibernate.Driver.SqlClientDriver\r
  34 \r
  35 - ar.connection.connection_string{1,2} set the connection strings for the test and test2 databases\r
  36 \r
  37     > -D:ar.connection.connection_string.1="Data Source=.;Initial Catalog=test;Integrated Security=SSPI;"\r
  38     > -D:ar.connection.connection_string.2="Data Source=.;Initial Catalog=test2;Integrated Security=SSPI;"\r
  39   \r
  40 Build options\r
  41 =============\r
  42 \r
  43 Disabling all tests\r
  44 -------------------\r
  45 \r
  46   > nant -D:common.testrunner.enabled=false\r
  47 \r
  48 Selecting a different test framework (EXPERIMENTAL)\r
  49 -------------------\r
  50 \r
  51 NUnit (default)\r
  52   > nant -D:testrunner=NUnit\r
  53 \r
  54 MbUnit:\r
  55   > nant -D:testrunner=MbUnit\r
  56 \r
  57 N.B.\r
  58 MbUnit or NUnit needs to be on the path, otherwise NAnt's built-in nunit2 task will be used.\r
  59 \r
  60 Compiling a Debug version\r
  61 -------------------------\r
  62 \r
  63   > nant -D:project.config=debug\r
  64 \r
  65 Compiling a version not strongly signed\r
  66 ---------------------------------------\r
  67 \r
  68   > nant -D:sign=false\r
  69 \r
  70 \r
  71 Allowing partial trust\r
  72 ----------------------\r
  73 \r
  74   > nant -D:assembly.allow-partially-trusted-callers=true\r
  75 \r
  76 \r
  77 Building the Castle MSI installer\r
  78 ----------------------\r
  79 \r
  80   > nant installer\r
  81   \r
  82 You need to have installed Sandcastle, Sandcastle Help File Builder, HTML Help 1.x compiler, and WiX v3 for running task.\r
  83 \r
  84 \r
  85 More questions? \r
  86 ===============\r
  87 \r
  88 Please direct more questions to our devel mailing list or our forum at http://www.castleproject.org/\r